home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_300 / 354_01 / cesmouse.doc < prev    next >
Text File  |  1991-08-20  |  56KB  |  1,849 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                              CESMouse Tools Library
  23.                                       With
  24.                           Complete Joystick Functions
  25.  
  26.  
  27.  
  28.                              Version 1.25 Shareware
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.           Copyright 1989, 1991. All Rights Reserved.
  52.  
  53.  
  54.           John F. Jarrett
  55.           Computer Engineering Services
  56.           Post Office Box 1222
  57.           Show Low, Arizona  85901
  58.           (602) 367-8996
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                TABLE OF CONTENTS
  73.  
  74.  
  75.  
  76.  
  77.           Program License ................................  1
  78.  
  79.           Introduction ...................................  2
  80.  
  81.           Installation ...................................  3
  82.  
  83.           Compiling with Power C .........................  4
  84.  
  85.           Compiling with Quick C and MS C 6.0 ............  5
  86.  
  87.           Compiling with Turbo C .........................  7
  88.  
  89.           Compiling With Quick Basic .....................  9
  90.  
  91.           Mouse Functions ................................ 11
  92.  
  93.           Example C Program For Mouse Functions .......... 20
  94.  
  95.           Joysticks ...................................... 21
  96.  
  97.           Joystick Functions ............................. 22
  98.  
  99.           Example C Source for Joystick Functions ........ 24
  100.  
  101.           Bug Report Form ................................ 25
  102.  
  103.           Product Registration ........................... 26
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                 PROGRAM LICENSE
  138.  
  139.  
  140.  
  141.          This manual,  as well as all  source code and object  code is
  142.          copyrighted material and is registered with the United States
  143.          Copyright Office, Copyright 1989, 1991.
  144.  
  145.          You, the  original purchaser, do  not own this  software, but
  146.          you have a non exclusive and non transferrable license to use
  147.          this software  on one machine. This  software is just  like a
  148.          book which cannot be read by another person at the same time.
  149.  
  150.          Therefore, you may use this software  on only one machine, or
  151.          one node of a network and make needed back up copies for your
  152.          own  archival use.  Site licenses  and  network licenses  are
  153.          available. Making copies  for another person is  not allowed,
  154.          and is a violation of the United States Copyright Law.
  155.  
  156.          You may combine the libraries, routines, functions and header
  157.          files into  your own  executable computer  programs that  you
  158.          write, as long as no source code of the functions within this
  159.          library are released and your program is compiled and linked,
  160.          without   paying  any   royalties   whatsoever  to   Computer
  161.          Engineering Services.
  162.  
  163.          Computer Engineering Services makes  no warranty expressed or
  164.          implied of any kind as to the suitability, merchantability or
  165.          applicability  of this  software  for  any purpose.  Computer
  166.          Engineering Services is  not liable for any  damages incurred
  167.          arrising out of the use or  inability to use this software by
  168.          you, others or otherwise.  Computer Engineering Services only
  169.          warrants  that the  magnetic  media  on which  this  software
  170.          resides is free from defects  in material and workmanship for
  171.          a  period  of ninety  days  IF  recorded and  distributed  by
  172.          Computer Engineering Services.
  173.  
  174.          Any reference  to Turbo C, Borland  C, Quick C,  MSC, MS-DOS,
  175.          MicroSoft Mouse or Quick Basic,  Power C, PC-DOS, Kraft Mouse
  176.          or Econo  Mouse, or others, are  for reference only,  and are
  177.          U.S.   Registered  Trademarks   of;  Borland   International,
  178.          Microsoft Corporation,  Mix Software,  International Business
  179.          Machines, (IBM), and Kraft Systems Inc.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                        1
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                  INTRODUCTION
  204.  
  205.  
  206.          Ever  since learning  to  write programs  for  a computer,  I
  207.          learned the  value of  "tools" that  have assisted  me in  my
  208.          endeavors. Often I  purchase "tools" to assist me,  such as a
  209.          window tool kit,  communications tool kit, graphics  tool kit
  210.          and the like. There are many programmers tool kits available.
  211.  
  212.          My biggest problem has been coming up with the price for some
  213.          of the tool  kits and then having to  purchase more functions
  214.          and routines than I really want or need.
  215.  
  216.          To this end, I have had to write many of my own tool kits, or
  217.          canned functions that I can use in my day-to-day programming.
  218.          Since I have yet to see a library of only mouse functions all
  219.          by themselves,  I created just  that. The C.E.S.  Mouse Tools
  220.          Library. This library has over fifty functions that deal only
  221.          with  MicroSoft compatible  mice.  These  functions give  you
  222.          almost complete control over mouse  motion and sensing in all
  223.          of your programs.
  224.  
  225.          Since  nearly all  mice  sold  for IBM  compatible  computers
  226.          running  under  PC-DOS  or MS-DOS  are  compatible  with  the
  227.          defacto MicroSoft Mouse  Driver, almost any mouse  driver and
  228.          mouse will  function with these  routines. However  there are
  229.          some functions that  will only work with  the MicroSoft Mouse
  230.          Driver.
  231.  
  232.          Since we  are dealing  with secondary  (mouse) input  for the
  233.          computer, the joysticks have also  been a problem to program.
  234.          BASIC has  joystick functions,  but not C  or Pascal.  I have
  235.          thrown them  in for  C programmers,  because many  still play
  236.          with joysticks.
  237.  
  238.          The mouse and joystick routines are  written in C and are all
  239.          debugged and ready  for you to use. All of  the functions are
  240.          optimized for speed, not size. The functions are all designed
  241.          to be almost fool-proof so that a newcomer as well as an "old
  242.          timer" can easily  integrate these functions into  his or her
  243.          program.
  244.  
  245.          Presently,  the   library  is  compiled  for   the  following
  246.          compilers:
  247.  
  248.  
  249.          Borland Turbo C version 2.0, Turbo C++ and Borland C++
  250.          Microsoft Quick C version 1.0
  251.          MicroSoft C 6.0
  252.          Mix Power C Version 2.0
  253.  
  254.  
  255.          GOOD LUCK!
  256.  
  257.  
  258.          John F. Jarrett
  259.          Computer Engineering Services
  260.  
  261.  
  262.                                        2
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                  INSTALLATION
  270.  
  271.  
  272.  
  273.          Installation of the CES mouse  and joystick library functions
  274.          is  straight   forward.  The  include  files,   cesjoy.h  and
  275.          cesmouse.h should be copied into the "include" subdirectories
  276.          of MicroSoft  Quick C,  c 6.0  and Borland  Turbo C,  and the
  277.          library files,  mouseqcx.lib, mousemsx.lib  and mousetcx.lib,
  278.          should be placed into the "lib" subdirectories of each, and x
  279.          is the memory model of  the libraries. (The ShareWare version
  280.          ONLY includes the medium memory model).
  281.  
  282.          For Mix Power C, the include  and library files can be placed
  283.          in the same Power C directory with all of the other files. It
  284.          may also be a good idea, if  you have version 2.0 of Power C,
  285.          to compile the include, (.h) files  into the .hhh header file
  286.          using the fasthdr.exe utility supplied with version 2.0.
  287.  
  288.          On the distribution disk you will  find in the root directory
  289.          the  include   files,  cesjoy.h,   cesmouse.h,  cesmouse.bas,
  290.          cesmouse.doc, (this file),  and a read.me file  that includes
  291.          any  last  minute  changes  in  the  documentation  or  files
  292.          included on the disk.
  293.  
  294.          There  will be  directories for  each  make or  version of  a
  295.          supported compiler. These directories are;
  296.  
  297.  
  298.          POWER_C    includes libraries for version 2.0
  299.          QUICK_C    includes